home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / diskutil / hramdisk.arc / HRAMDISK.TXT < prev   
Text File  |  1988-06-19  |  10KB  |  202 lines
  1.  
  2.  
  3.             HybriSwitch Ram Disk Documentation
  4.                   version 1.0 - 06/19/88
  5.                Copyright 1988 John Eidsvoog
  6.  
  7.  
  8.     This is a stand-alone version of the HybriSwitch Reset-proof Ram Disk.
  9. It is different from other 'reset-proof' ram disks in that they require an
  10. extra reset when installing.  The HybriSwitch Ram Disk is able to accomplish
  11. the same task without having to reboot.  Reset-proof means that the files will
  12. still be intact after a 'warm' reset.  A 'warm' reset happens when you push the
  13. reset button (assuming that certain system variables are intact), or upon
  14. recovering from some crashes.  This means that if a program crashes, or hangs,
  15. you can reset and recover your files from your ram disk.  After a warm reset,
  16. HybriSwitch Ram Disk must run again in order to re-install the ram disk.  This
  17. will happen automatically if you keep it in your AUTO folder.
  18.  
  19.     This program has been released in the public domain.  You may
  20. distribute it freely.  Please, for everyone's benefit, make sure that this
  21. doc file is included.  This version has been released as an ARC file called
  22. HRAMDISK.ARC, containing: HRAMDISK.PRG and HRAMDISK.TXT.
  23.  
  24.  
  25.  
  26. WHAT IS HybriSwitch:
  27.  
  28.     HybriSwitch is a multi-application manager that allows you to have
  29. multiple programs in memory and switch instantly between them.  It is available
  30. through dealers of Hybrid Arts products.
  31.  
  32. Current programs supporting HybriSwitch include:
  33.  
  34.    Hybrid Arts Products:
  35.     MidiTrack ST - family of sequencers
  36.     GenPatch ST  - generic MIDI librarian, works with ALL instruments!
  37.     EZ Score+    - scoring program, laser-like output from 9-pin printers
  38.     Ludwig       - real-time composition
  39.  
  40.    Other:
  41.     ArcShell by Charles F. Johnson.  The Rolls-Royce of ARC utilities.
  42.  
  43.     Developers are invited to contact Hybrid Arts, Inc. at (213) 826-3777
  44. for information on implementing some of the powerful features of HybriSwitch.
  45. While HybriSwitch only allows one to reenter compatible programs, it can still
  46. run ANY 'legal' ST program and upon quitting, reenter any compatible program.
  47. Up to 16 programs may be in memory at one time.  There is also a 'shared data'
  48. mechanism which allows programs to exchange data.  For instance, Ludwig, (a
  49. real-time composer), can compose its songs directly into the MidiTrack song
  50. buffer.  They can then be edited, have tracks added, or whatever.
  51.  
  52.     HybriSwitch has a duplicate of this ram disk built right into the
  53. program.  When you run HybriSwitch with this ram disk installed, a message
  54. will appear showing that the ram disk has been recognized, and it will re-
  55. install it if it hasn't yet been re-installed.
  56.  
  57.  
  58.  
  59. SETTING UP HybriSwitch Ram Disk:
  60.  
  61.     Copy the file HRAMDISK.PRG into your AUTO folder (make a folder on
  62. your boot disk named AUTO).  Whenever the ST boots up, it runs all programs
  63. with the extension .PRG in the AUTO folder.  If you are booting from hard disk,
  64. your AUTO folder will need to be in your boot partition.  You may also run
  65. HRAMDISK.PRG directly from the desktop.
  66.  
  67.  
  68.  
  69. USING HybriSwitch Ram Disk:
  70.  
  71.     When HRAMDISK.PRG is run from the AUTO folder, it will pause for about
  72. 5 seconds.  If you don't respond by pressing a key or moving the mouse within
  73. 5 seconds, the program will proceed automatically with the rest of your bootup
  74. procedure.  The action that will be taken will be noted at the bottom of the
  75. screen by one of the following 2 messages:
  76.  
  77.         (on time-out, will automatically install)
  78.                      or
  79.         (on time-out, will automatically by-pass)
  80.  
  81.     As soon as you press a key or move the mouse, this message will dis-
  82. appear, the time-out will be aborted, and you will have as long as you want to
  83. decide what to do.  The following are valid keys:
  84.  
  85.     <Control> C-P                  = set the drive letter to use
  86.     1-9, A-W (upper or lower case) = install, using the size shown on screen
  87.     Esc, or Undo                   = quit without installing ram disk
  88.     Arrow keys and mouse movements = move the cursor around on the screen
  89.     Space bar                      = does nothing (expect abort time-out)
  90.     Help, or any other key         = display information about the program
  91.     Delete                         = do a cold boot (if already installed,
  92.                                                      and pressed before run)
  93.  
  94.     Every time HRAMDISK is run, it saves the current size chosen, the drive
  95. letter selected, and whether the ram disk was installed or by-passed.  Then the
  96. next time the program is run, the previous settings will be used as default
  97. values.  If you do not want this information saved every time, you must write-
  98. protect your disk.  It is still much more preferable (to me) to have your
  99. 'favorite' drive and size appear as the default size and action each time you
  100. run it, and if you're not there to respond within 5 seconds, it'll go ahead and
  101. do the same thing you did last time.
  102.  
  103.     Once you install the ram disk, a message will appear showing the
  104. selected drive and size, e.g.:
  105.  
  106.     1102 K ram disk installed as drive E
  107.  
  108.     This same message will appear every time HRAMDISK runs after a 'warm'
  109. reset.  It is your way of knowing that your ram disk and files are still there.
  110.  
  111. NOTE:   It is still possible that a system crash will trash your files, even
  112.     though they appear to be all right.  This can't be helped.
  113.  
  114.     In order to use the ram disk from the desktop, you will have to install
  115. a drive icon.  Do this by clicking on an existing drive icon.  It will become
  116. selected by inverting its colors.  Now go up to the Options drop-down and
  117. click on 'Install Disk Drive...'.  A dialog box will appear.  Enter the drive
  118. letter that you have chosen for your ram disk, and the name you'd like to
  119. appear on the icon.  Make sure you click the mouse on 'Install' because using
  120. the 'Return' key will 'Cancel'.  If you have problems, your Owner's Manual
  121. describes this whole process.
  122.  
  123.     The ram disk may be used as any other disk drive, but you will not be
  124. allowed to do a disk copy by dragging its icon to another drive icon.  Copies
  125. must be made by dragging files.  You can, however, drag a floppy disk icon into
  126. an open window of the ram disk.  This will initiate a copy of all the files on
  127. that disk.
  128.  
  129.  
  130.  
  131. REMOVING HybriSwitch Ram Disk:
  132.  
  133.     In order to remove this ram disk, you must do a 'cold' reset.  One way
  134. to do this is to turn off the power switch in the back of your ST.  To insure
  135. that you truly have a 'clean' machine, you must wait at least 5 seconds, maybe
  136. 10, before turning it back on.  If this seems a nuisance, just be aware that
  137. this feature, depending on your individual ST, might make it possible to
  138. recover files on your ram disk even if the machine is turned off for a few
  139. seconds!!  You can also do a cold reset by running HRAMDISK from the desktop.
  140. The alert box that appears will show 'Cold Boot' as one of the choices.  One
  141. final way to remove the ram disk is to press the 'Delete' key before HRAMDISK
  142. runs (re-initializing the ram disk).  This key must be pressed before the
  143. installation message appears.
  144.  
  145.  
  146. ABOUT FATs:
  147.  
  148.     A FAT is a File Allocation Table.  It specifies which sectors
  149. (clusters) are used and in what order.  To make the most efficient use of
  150. memory, the size of our FAT is calculated based on the size of the ram disk
  151. chosen.  This way a small ram disk only uses one sector per FAT instead of
  152. wasting 7 or 8 sectors required for a large one.
  153.  
  154.  
  155.  
  156. MISCELLANEOUS:
  157.  
  158.     This ram disk only allows sizing by 64K increments.  HybriSwitch allows
  159. you to configure to any size.  If you install a ram disk from HybriSwitch that
  160. is between the available sizes of this ram disk, the warm reset install message
  161. will show the next lower size.  The same size ram disk will still be used
  162. internally.  To find out the exact number of bytes available, you should do a
  163. 'Show Info' from the desktop.
  164.  
  165.     To save time and space, this program only recognizes certain ROM
  166. versions.  If an unknown ROM version is used (future Atari releases), the
  167. ram disk will still work fine, it will just reset the system and reboot like
  168. all the other reset-proof ram disks.  If a memory block the size of the ram